home *** CD-ROM | disk | FTP | other *** search
/ Speccy ClassiX 1998 / Speccy ClassiX 98.iso / amiga_system / the_aminet / comm / tcp / slipcall30b1.lha / SLIPCall30 / mbwatch / mbwatch.doc < prev    next >
Text File  |  1995-09-16  |  5KB  |  144 lines
  1.                                     MBWatch
  2.                                     =======
  3.  
  4. About this program
  5. ==================
  6.  
  7. This is the 2nd release of my timer program.  I've written this program in order
  8. to have a small, handy timer to control the time I spend e.g on IRC and to help
  9. me, reduce my phonebills. I've been searching for such a program for quite a
  10. long time and didn't find any comparable tool. And this stuff like e.g MagicCX
  11. is IMHO quite too buggy and eats too much of my valuable memory. In the first
  12. place my intention was, to leave this program as small as possible, but mean-
  13. while I've added some quite useful features and it got slightly bigger and it'll
  14. grow a bit in the future. So, if you'd like to have some more special features
  15. in this program, please be so kind and let me know your very special needs. I
  16. won't implement everything, but as you might notice, I've implemented some
  17. wishes by some users of my first version.
  18.  
  19. Usage
  20. =====
  21.  
  22. Start MBWatch by starting it from a shell or from a script.
  23.  
  24.     MBWatch X=XPOS/N,Y=YPOS/N,SCR=SCREEN/K,S=START/S,LOGTIME/N,SEC/N,MIN/N,HOUR/N,
  25.             ALARM/N,SAMPLE/K
  26.  
  27.     XPOS        Left Edge of the Window
  28.                                         !!! Currently, I don't check your values
  29.     YPOS        Top Edge of the Window
  30.  
  31.     SCREEN      You may enter the name of your favorite PubScreen
  32.  
  33.     START       The timer is resetted and starts automatically
  34.  
  35.     LOGTIME     Time distance in seconds. MBWatch will update the s:.mbwatch
  36.                 file after n seconds. If you start MBWatch a second time after
  37.                 e.g a crash, it'll continue with the last logtime. This file
  38.                 will be deleted, everytime you leave MBWatch the "normal" way.
  39.  
  40.     SEC         This will give you a certain time offset. E.g the timer starts
  41.     MIN         to count about half a minute after the handshake has started,
  42.     HOUR        so you'll be able to give a preset.
  43.  
  44.     ALARM       You may set an alarm time in seconds. When the given time is
  45.                 over, there'll be either a DisplayBeep or an 8svx sample will
  46.                 be played.
  47.  
  48.     SAMPLE      If you place the path to an 8svx sample here, it'll be played
  49.                 when the alarmtime has passed.
  50.  
  51. ARexx
  52. =====
  53.  
  54. MBTimer installs an ARexx port for each Window you open. They'll be named
  55. 'MBWATCH.00' through 'MBWATCH.99'.
  56.  
  57.     Commands:
  58.  
  59.         START       Start the timer
  60.  
  61.         STOP        Stop the timer
  62.  
  63.         RESET       Reset the timer
  64.  
  65.         QUIT        Quit this program
  66.  
  67.         GETTIME     Return the time string
  68.  
  69.     Invocation via e.g your shell:
  70.  
  71.         rx "ADDRESS MBWATCH.01; START"
  72.  
  73. How I use this program
  74. ======================
  75.  
  76. I use Jochen Wiedmann's IPDial to startup my slip  line  via  AmiTCP.  When  the
  77. connection  is established, I use the script (and my enhanced version of IPStart
  78. - I'll give it to Jochen soon ;c) ) to start MBWatch and to start the timer.  In
  79. my Stopnet script I stop this timer again.
  80.  
  81. Legal Stuff
  82. ===========
  83.  
  84. This program is Giftware. If you like this program, I'd be glad if you'd send me
  85. something.  A  huge  bag  full  of  money, a cd, a new car, hmmm, what about ...
  86. *grin*. No, give me some response, send me your suggestions, tell  me  what  you
  87. like about this program, or tell me what you'd like to see in future versions.
  88.  
  89. Future Plans
  90. ============
  91.  
  92.     o   Including more shell arguments
  93.     o   Fixing some stupid things
  94.     o   Perhaps your idea ...
  95.     o   A better documentation
  96.     o   Perhaps a log function for e.g PhoneBill or similar programs
  97.  
  98. History
  99. =======
  100.  
  101.     1.0b    First official release
  102.  
  103.     1.0a    Added Ctrl-C handling
  104.             Added the GetTime ARexx command
  105.  
  106.     1.0     Added a logfile option
  107.             Removed autoactivation of the window.
  108.             Added Alarm function
  109.             Added Preset capability
  110.             Now you can add several windows
  111.             Window will open on the DefaultPubScreen if the given screen is not
  112.                 available.
  113.  
  114. Thank you
  115. =========
  116.  
  117.     To GWAR, Colloseum, Emerson Lake & Palmer, Faith no more, Rainbow
  118.  
  119.         Their music inspired me while working on this program.
  120.  
  121.     3 or 4 guys who gave me some inspirations about this program.
  122.  
  123.         Sorry, I don't know, where the piece of paper with your names has
  124.         gone. The only one I can remember right now is 'obw' at #amigager.
  125.     Ah, there it is, there's a guy called Geoff, Thomas Egrelius,
  126.     Stefan Konst, Martin Koyro and at least another guy, but I can't
  127.      find him, sorry ;c)
  128.  
  129.     All the people at #amigager
  130.  
  131. Author
  132. ======
  133.  
  134.     Michael Bauer
  135.     Hegelstr. 27
  136.     72072 Tuebingen
  137.     07071/72293
  138.  
  139.     EMail: michael.bauer@zdv.uni-tuebingen.de (this one is preferred)
  140.     or     u195305@pluto.rz.fh-reutlingen.de
  141.     IRC:   Gutgolf@#amigager
  142.     WWW:   http://pluto.rz.fh-reutlingen.de/~u195305/index.html
  143.  
  144.